home *** CD-ROM | disk | FTP | other *** search
/ Chip 1998 November / CHIP Kasım 1998.iso / emulators / atari2600 / vcs2600.exe / README.DOC < prev    next >
Text File  |  1996-10-20  |  17KB  |  460 lines
  1. Documentation - Seventh Release
  2.  Thomas DJAFARI
  3.  5,avenue de l'egalite
  4.  95250 Beauchamp
  5.  France
  6.  +33 0134180596
  7.  frogger@micronet.fr
  8.  http://www.micronet.fr/~frogger
  9.  
  10.  
  11.      Disclaimer:
  12.     -------------
  13.  
  14.     Also the 'VCS2600' software  was  tested on many different systems
  15.     in various configurations, a 100 percent correct function under  all
  16.     circumstances  could not be guaranteed.  I take no liability of any
  17.     appearing malfunctions of Your system when running 'VCS2600'.
  18.  
  19.  
  20.     The VCS2600 emulator and accompanying files are copyrighted
  21.     (C)1996 Thomas Djafari and may not be copied, sold, hired, modified
  22.     or distributed in any way without written permission of the
  23.     author. (including magazines and pd distributors)
  24.     I reserve the right to sue anyone failing with these conditions.
  25.  
  26.  
  27.     VCS2600 is free but it's NOT Public Domain, it is a copyrighted software product and
  28.     may not be disassembled, reverse engineered or otherwise modified in any way.
  29.     I STRONGLY WARN YOU AGAINST ANY MODIFICATIONS OF THE PROGRAM.
  30.     I can not be taken for reponsible of any data loss or alterations if you failed
  31.     tthis condition.
  32.     IF YOU DON'T AGREE OR FEEL UNCOMFORTABLE WITH THIS, DELETE THE EMULATOR NOW FROM YOUR DISK.
  33.  
  34.  
  35.  
  36.  
  37.  VCS2600
  38.  
  39.  VCS2600 is an Atari 2600 emulator.
  40.  It supports : 
  41.  
  42.  Video : all functions
  43.  Sound : all modes;
  44.  IO    : joystick, paddle, keypad
  45.  Memory: The 2600 has capability to handle cartridges of 2 and 4kb
  46.          Bigger cartridges use a built-in paging mechanism.
  47.          This system allows the program to switch the rom banks in
  48.          the rom area
  49.          Of course, in order to make things worse, each company
  50.          decided to make their own system.
  51.  
  52.          The common systems were :
  53.          Atari
  54.          Activision
  55.          M-Network
  56.          CBS
  57.          Parker Brothers
  58.          Mattel
  59.          Atari designed the 'superchip' : 16kb rom and 128 bytes of ram
  60.  
  61.          To summarize : VCS2600 support them all but there are still some
  62.          problems with Mattel cartridges.
  63.  
  64.  
  65.  Required configuration :
  66.  At least a fast 486
  67.  4Mb of ram, 8mb was needed for the first version
  68.  A vesa 2 driver WITH linear frame buffer
  69.   If you don't have it, just go to:
  70.   www: http://www.scitechsoft.com 
  71.   ftp: ftp.scitechsoft.com
  72.   email: sales@scitechsoft.com 
  73.  
  74.  Let's take each point :
  75.  
  76.  ROM FILES:
  77.  You need rom dumps to play games. The commercial version will include a
  78.  cartridge reader. These dumps can be of 2048,4096,8192,12288,16384 bytes.
  79.  There are no headers.
  80.  THE ROMS ARE STILL COPYRIGHTED ! even if many people say "they are just old
  81.  games, no problem" THEY ARE WRONG.
  82.  Companies such as Atari, Activision, Parker Brothers, 20th Century Fox,
  83.  CBS are still here and they still have their copyrights on games.
  84.  According to the law, you can use the rom from the cartridges you own.
  85.  ALL GAME ROMS MUST BE IN THE DIRECTORY  roms   ,   list.txt must be in the directory roms too.
  86.  
  87.  DISPLAY:
  88.  The program can run in eight modes :
  89.  640*480, 640*400, 640*350 and 320*200(2modes), 320*240(2), 320*400
  90.  Some boards will refuse some modes. The default mode is 320*240
  91.  F7,F8 toggles between the modes (if all available).
  92.  Use + and - to adjust vertically the picture
  93.  Screen goes up and down in some games I've not the solution
  94.  to fix it right now.I  tried several things with more or less success.
  95.  
  96.  VESA 2 is recommended for vcs2600 for better overall preformance and all video modes;
  97.  VESA 1 and no VESA were added by requests but there are display bugs (looks like vertical bars)
  98.  VESA 1 and novesa are slopwer and can CRASH SOMETIMES
  99.  BIOS in Matrox Cards (VESA 2) is bugged - Use UnivBe (UnivBe is known as DISPLAY DOCTOR);
  100.  On some ATI BIOS, it might take up to 20 seconds to start!;
  101.  When the pics are not centered properly (+ and - keys), some bugs may appear;
  102.  There a try to limit the flicker -- set sync=x (where 'x' is 0, 1, or 2) some modes may not work on all cards;
  103.  
  104.  
  105.  SOUND:
  106.  The sound uses the soundblaster.
  107.  You need to have the Blaster environment chain set:
  108.  ex :'set blaster=A220 I5 D1 H5'
  109.  If the Sound Blaster is installed from win, the chain is not always set (blaster chain);
  110.  remove the blaster chain to disable sound (It takes CPU time to have sound);
  111.  Software Sound Blaster emulation doesn't work (ie. gus, etc)
  112.  Wrong values in the chain may crash the computer.
  113.  
  114.  
  115.  CPU:
  116.  The whole 6507 is emulated, but there's still a bug in some BCD operations
  117.  so if you play at 'fun with numbers', 11+9 can be 12 !
  118.  It will be fixed very soon.
  119.  
  120.  
  121.  WINDOWS:
  122.  it runs with win3 and 95
  123.  the speed limiter is disabled with windows as it's impossible to have a reliable
  124.  timer under windows
  125.  
  126.  
  127.  
  128.  ESC - in menu : quits
  129.      - in game : menu
  130.  
  131.  F1  - On/Off The snow has been reported to be wrong on some boards. I need details
  132.  F2  - Color/BW
  133.  F3  - Game Select
  134.  F4  - Game Reset
  135.  F5  - Difficulty 1 (b mode by default)
  136.  F6  - Difficulty 2 (b mode by default)
  137.  F7  - Previous video mode
  138.  F8  - Next video mode
  139.  F9  - Toggles between 2 palettes (the default is the 7800 one, the second one
  140.        is the standard one). I find the 7800 more pretty.
  141.  [ and ] to adjust the luminosity
  142.  + and - adjust the vertical display
  143.  . or `   - selects the control menu
  144.  q and w adjust contrast
  145.  s - toggles speed limiter (60hz) MAY CRASH ON SOME COMPUTERS
  146.  10 saves the screen position for a game -- If the game had been loaded from the menu;
  147.  Snapshots (TAB) work only if the game is not loaded from the menu
  148.  The 'J' key redects the joysticks and recalibrates them (red flash),
  149.   this allows you to plug a joy while playing;
  150.  
  151.  If you already have a joystick plugged in, it is selected by default instead of keyboard
  152.  
  153.  Scroll lock activates the debug mode (you need two video cards for this)
  154.  
  155.  GAME SELECTION:
  156.  The emulator loads a file called list.txt in the roms directory (recommended)
  157.  or in the vcs2600 directory.
  158.  
  159.  This file contains a description to many games. You can read the list,
  160.  move with keys, page-up, page-down.
  161.  You can use the joy and the letters too.
  162.  Games you have will be darker.
  163.  Press joystick button or return to choose a game.
  164.  superchip, cbsram+, paddle, joy and keypad indicators don't work.
  165.  
  166.  Here's a snapshot of the list file:
  167.  the first field is the file name as it appears in the rom directory
  168.  don't edit the second field, leave it blank if you insert any title
  169.  the field 3 is the rom size : must be : 02K 04K 08K 12K or 16K
  170.  the field 4 is about the memory system, for cartridges of 8kb and more
  171.  it can be :
  172.    F6    FF6/FF7/FF8/FF9 bankswitching
  173.    F8    FF8/FF9 bankswitching
  174.    FA    FF8/FF9/FFA bankswitching (aka CBS' RAM Plus)
  175.    E0    FE0-FF7 bankswitching (aka Parker Bros.)
  176.    E7    FE0-FE7 bankswitching found on M-Network carts
  177.    FE    01FE/11FE bankswitching (aka Activision Robot Tank)
  178.    FE    01FE/11FE bankswitching (aka Activision Robot Tank)
  179.    F1    FE0-FE7 Mattel w/RAM (Burgertime, He-Man, Bump n Jump?)
  180.    F4    FF4/FF5/FF6/FF7 Activision (Rampage)
  181.  
  182.  field 5 is for super chip cartridges (some of 16kb); SC must be inserted
  183.  field 6 contains the info on the device to emulate on each port :
  184.    J for joystick
  185.    P for paddle (only one allowed at this time with the mouse)
  186.    K for keypad (only one allowed at this time with the real keypad)
  187.  
  188.  the field 7 is either 'PAL ' or 'NTSC' to adjust the sync and screen size.
  189.   'SECA' for secam is to come (you'll see the ugly colors we have in France !)
  190.  
  191.  the following things are : the reference, the manufacturer and the game's name.
  192.  
  193.  THE ALIGNEMENT OF THE '|' CHARACTERS MUST BE KEPT !
  194.  
  195.  
  196.  CRUSMISL.BIN|{5161A246}|04K|  |  |J J|NTSC|FG1007    |Froggo                |Cruise Missile            |
  197.  CRPTCHOS.BIN|{C5B29962}|04K|  |  |J J|NTSC|11009     |20th Century          |Crypts of Chaos           |
  198.  CRYSCAST.BIN|{9007B5AC}|16K|F6|SC|J J|NTSC|CX26110   |Atari                 |Crystal Castles           |
  199.  CUBICOL.BIN |{D5D43A7A}|04K|  |  |J J|NTSC|????      |Imagic                |Cubicolour                |
  200.  CUSTEREV.BIN|{21283941}|04K|  |  |J J|NTSC|1001      |Mystique              |Custer's Revenge          |
  201.  
  202.  
  203.  BTW most common games on the net have been listed and all you'll have to do is to add the rom
  204.  files to the archive without having to edit the list.txt
  205.  
  206.  
  207.  THE RAR FILE:
  208.  'Where is it' will ask all registered users.
  209.  I removed it, it caused too many problems and worst the rar site was under
  210.  work, so many people didn't got the 1.55.
  211.  put all roms and list.txt in a \roms\  directory.
  212.  ALL GAMES ARE UNPACKED
  213.  THEY MUST BE PUT IN THE 'ROMS' DIRECTORY.
  214.  
  215.  
  216.  DIRECT LOAD:
  217.  
  218.  VCS2600 combat.bin will load combat.bin directly, BUT ! you can't play
  219.  all games using this method.
  220.  To load a superchip game, use '!' in front of the name.
  221.  Example : vcs2600 !jrpacman.bin
  222.  
  223.  
  224.  
  225.  
  226.  YOU ! YES YOU !
  227.  Help me ! report all bugs !
  228.  I don't answer to question answered in this doc
  229.  
  230.  
  231.  
  232.  
  233.  DON'T -- Pack the exec, change the stub, or add a virus check to the exec, it won't function anymore!!!;
  234.  When you exit the emu, it saves the video mode, lum, and contrast.  Type  vcs2600 /?  to get info;
  235.  
  236.  DON'T modify the exec in any way, it could cause you some disagrements
  237.  
  238.  
  239.  
  240.  KNOWN BUGS:
  241.  - SPRITE WRAP
  242.      not all sprite modes wrap
  243.  - CPU
  244.      BCD has problems !
  245.  - BACKGROUND
  246.      problems in games like crystal castles, etc.
  247.  
  248.  REMEMBER : THIS VERSION HAS NO COLLISIONS , THEY WILL BE ENABLED ON
  249.  THE FINAL VERSION
  250.  
  251.  THIS VERSION IS CONSIDERED AS A TEST : IF I SEE SOMETHING MODIFIED OR SO
  252.  I WON'T RELEASE PUBLIC VERSIONS ANYMORE
  253.  
  254.  
  255.  
  256.  TELL ME: I wanted to add cartridge label snapshots in the menu (one for each rom)
  257.  it will be done if I get enough requests.
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264. Fixes :
  265. -----------------------------------------------------------------------------
  266.  
  267. Lots of improvements in the sound, pitch should be ok, noise should be off key.
  268. It should work with *ANY* version of UniVBE
  269.  (this was SciTech Soft's Fault ! no kidding !)
  270. 6 video modes (640 by 350,400,480 and 320*200,240,400) you can switch
  271. them using f7 and f8
  272.  
  273. New palette : toggles between what seems to be the real palette
  274. and the 7800 palette ( nicer I think) using F9
  275. (here in France we don't have the true colors (frogger's water is red here !))
  276.  
  277. -----------------------------------------------------------------------------
  278.  
  279. You can adjust scren bright using [ and ]
  280. The F1 key switches the console on and off
  281.  the snow is ok,
  282.  I've still the noise to do.
  283. Invalid opcode fixed (pole position)
  284. Video blank fixed (all mystique games, etc.)
  285. Timer 100% accurate now :
  286.  all games have a stable screen; jr. pacman ghosts move ok
  287.  most enemies are ok now, etc.
  288. -----------------------------------------------------------------------------
  289.  
  290. Corrected a bug in the latches (I thought the not instruction updated the
  291. flags !)
  292. The paddle's trigger now works ok
  293. Sounds better : I NEED SOMEONE THAT KNOWS HOW TO REPRODUCE SOME SOUNDS
  294.  WITH AN ADLIB
  295. Runs FASTER !
  296. Stability improved (it was bugged last time)  space invaders
  297.  and phoenix have problems now !
  298. The snow is more 'compatible' with other video cards than mine.
  299.  Tell me about it.
  300.  
  301. -----------------------------------------------------------------------------
  302.  
  303. A few things in this one :
  304. The difficulty switches are re-enabled (f5 and f6)
  305.  I disabled them while I was rewriting
  306.  the keyboard handler and forgot to put them back !
  307. Stable display ! truely ! this bug was introduced two updates later
  308.  it's now fixed. The vblank register work with any problem noticed.
  309. Sprite adjustment better (basic programming)
  310. As it's a pretty small release, I included one of the collision (ball-pf)
  311.  so try adventure, phoenix's end ship, etc<BR>
  312. As of now, three people reported a complete crash, I'm trying to investigate.
  313.  
  314.  
  315. -----------------------------------------------------------------------------
  316.  
  317. I started the support for non vesa 2 cards. it's not finished yet.
  318. Runs a bit faster.
  319. Warlord's display is now wrong ! I'll make the correction very soon.
  320.  (It was ok two or three releases ago)
  321. Fixed playfield display is several cases (mr do, dig dug) not found the
  322.  problem on berzerk and crystal castle
  323. I changed the way I was refreshing the IO (keyboard, joystick) and now most
  324.  games that crashed before work ok.
  325. The thing runs a bit faster.
  326. I started a file to report bugs on all games, please update it and send it
  327.  back to me, I'll put it in each update. If you update this file often,
  328.  I'll  be able to fix bugs faster.
  329. I started to get cartridge label scans and game docs' text, if you can help
  330.  tell me. I'll include them in the menu
  331.  
  332. About the sound :
  333. With the help of Ronald Fries, I've fully understood how the modes that are
  334.  not emulated work. Now I can put the sound exactly as in a real 2600
  335. I'm trying to minimize the IRQ overhead involved and I need a method to
  336.  play a sound WITHOUT triggering an irq on a sound blaster
  337.  could someone help ?
  338. I need someone that has a good knowledge of the OPL-3 too.
  339.  
  340. -----------------------------------------------------------------------------
  341.  
  342. Support for non vesa 2 cards added. You can't use the menu yet in this mode
  343.  (load the games directly)
  344. Some screen shaking removed.
  345. Screen position is no longer wrong when using the vertical adjustment in high
  346.  res modes.
  347. Joy and paddles are not yet emulated on the keyboard, but I included the
  348.  screen that will be used; any comments on it ?
  349. The snow is not available on non vesa 2 cards, but the on/off
  350.  feature works.
  351. HEAVY OPTIMIZATIONS : IT RUNS AT LEAST 30% FASTER !
  352.  
  353. -----------------------------------------------------------------------------
  354.  
  355. I got no Internet access for a week
  356. This latest release has many new things
  357.  
  358. - Windows 3 and 95 compatibility
  359.   Please don't report problems with windows, I won't correct them
  360.   Sometimes the joystick isn't well calibrated.
  361.   BTW : this is a dos product, windows slows it down.
  362. - Sound for sound blaster ok
  363.   (I tried it on an awe32, I try the gus now ! : it doesn't work with sbos !)
  364. - Controls configurables ('.' on the keypad)
  365. - VDEL bugs fixed
  366. - NUSIZ bugs fixed
  367. - Works with : no vesa, vesa 1 and vesa 2
  368.   no vesa : no menu, display bugs
  369.   vesa 1 : menu (slow boot) and display bugs
  370.   vesa 2 : all ok
  371.   The no vesa and vesa 1 modes are not recommended
  372. - some games are still unstable
  373. - CBS modes debugged
  374. - still some bugs on parker and m-network modes
  375. - collisions m0/pf and m1/pf added
  376. - keyboard handler rewritten, no more stuck keys
  377. - Screen recentered correctly in all modes.
  378. - Support for 2 real joystick ok
  379. - F9 takes care of the bw/color switch now
  380. - J key recalibrate and redect joysticks on the fly
  381.   (available from game and control menu)
  382.  
  383. NEW FILE NEEDED :
  384. the file ct.raw needs to be either in your vcs2600 directory
  385. or best in the vcs2600.rar file inside its data directory
  386. I provided a file (up.bat) that updates the vcs2600.rar file
  387.  
  388. -----------------------------------------------------------------------------
  389.  
  390. Corrected bug when loading multiples games from the menu
  391. Corrected timer speed problem
  392. Added on/off sound when switching the console on/off 
  393. Speed limit system added
  394. Added PIF file
  395. Irregular speed under windows removed (provided you use the pif file !)
  396.  
  397. Does someone has to sell / give :
  398.                     - Pitfall II
  399.                     - Miner 2049 er
  400.                     - Supercobra
  401.                     - A supercharger
  402.  
  403. -----------------------------------------------------------------------------
  404.  
  405. Corrected system that limits speed.
  406. Now you can enable/disable it by pressing 's'.
  407.  
  408. -----------------------------------------------------------------------------
  409.  
  410. Speed limiter should be accurate now
  411. Sound tested on AWE32, SB16
  412. Setting the controls doesn't crash anymore
  413. Added a new video mode
  414. Added contrast keys (q and w)
  415. A bit faster
  416.  
  417. Correction :
  418. I said an old bug was SciTech's fault, I didn't read the doc completly
  419. It was my fault !
  420.  
  421. -----------------------------------------------------------------------------
  422.  
  423. Boot time is lots faster on vesa 1 and no vesa
  424.  
  425. First support to remove black lines :
  426.  on some video boards, It may slow down : TELL ME, I WAIT REPORTS
  427.  TO DECIDE THE WAY I WILL MAKE IT
  428.  Type 'set sync=1' to activate this function
  429.  
  430. Added a new video mode
  431.  
  432. New bug appeared in 'ADVENTURE'
  433.  
  434. 'Supercharger' support in work
  435.  
  436. -----------------------------------------------------------------------------
  437.  
  438.  Too many things modified to list.
  439.  RAR file removed
  440.  
  441.  COMBAT HAS A NEW BUG
  442.  if you experience some crashes, try nosync.exe
  443.  
  444. -----------------------------------------------------------------------------
  445.  
  446. English corrections and additions:
  447. Phaeton helped in this document.  Catch him on EFNet on #emu or mail him for
  448. questions at ronchero@juno.com
  449.  
  450. Thanks to Adam Roach (Tech Help) and Ronald Fries (Sound help)
  451. Thanks to the testers and people that were sending reports.
  452.  
  453. (C) 1996 Thomas Djafari
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.